home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Toolbox / Visual Basic Toolbox (P.I.E.)(1996).ISO / setup_ut / gbsetup / readme.txt < prev    next >
Text File  |  1995-08-17  |  5KB  |  154 lines
  1. GBSETUP (SETUP.EXE) by Gordon Bamber (c)1995
  2. ============================================
  3.  
  4. PURPOSE
  5. =======
  6. This file is intended to be a replacement for the
  7. Microsoft-supplied SETUP.EXE that comes with their
  8. excellent VISUAL BASIC(tm) V2.0 and V3.0 products.
  9. As VB4 has not been released at the time of
  10. writing (Aug1995) I have no idea of its useability
  11. with VB4.
  12.  
  13. SETUP.EXE will copy the files in SETUP.LST to the
  14. users SYSTEM directory, and then run SETUP1.EXE,
  15. passing it the current drive as a parameter.
  16. Multi-disk installations are supported.
  17. It can be used as a direct replacement for the
  18. supplied SETUP.EXE with no modifications. (see SETUP.INI)
  19.  
  20.  
  21.  
  22. DISTRIBUTION AND LICENSE
  23. ========================
  24. SETUP.EXE was written from scratch in Turbo Pascal V1.5,
  25. and is entirely original code. As such, it is copyright
  26. material.
  27.  
  28. SETUP.EXE is distributed FREE of royalties or charge by
  29. the author (Gordon Bamber) under the following conditions:
  30.  
  31. 1) Source code is not available or distributable.
  32. 2) Version information in SETUP.EXE remains untouched.
  33. 3) The author accepts no responsibility in its use or misuse.
  34. 4) Copyright remains with the author.
  35.  
  36.  
  37.  
  38. DIFFERENCES FROM MS SETUP.EXE
  39. =============================
  40. 1) Size. This version is approx 4KB smaller.
  41. 2) Speed under the Windows 95 operating system.
  42.    When using tyhe Add/Remove Programs applet
  43.    in Windows 95, the MS SETUP.EXE takes an
  44.    inordinate amount of time to initialise, and
  45.    gives the impression of a locked-up system.
  46.    This SETUP.EXE is slightly faster.
  47. 3) Copying time. If the items on SETUP.LST are already
  48.    present in the target \SYSTEM directory, then
  49.    they can optionally be skipped, thus speeding
  50.    up the bootstrap process considerably. (especially
  51.    when testing/debugging under development)
  52. 4) Configurability. You can put your own caption on
  53.    the SETUP.EXE title-bar. SETUP.EXE can optionally
  54.    use a configuration file SETUP.INI for this. The
  55.    format of SETUP.INI is below; choices are in square
  56.    brackets. If a keyword is absent, a default is chosen.
  57.    SETUP.INI would be on the same disk as SETUP.EXE
  58.  
  59.  
  60. Format of SETUP.INI
  61. ===================
  62. SETUP.INI has only one section, and nine keywords.
  63.  
  64. [SETUP]
  65. ForceCompatible=[yes/no][true/false][0/1][0/-1]
  66. AlwaysOverwrite=[yes/no][true/false][0/1][0/-1]
  67. Quick=[yes/no][true/false][0/1][0/-1]
  68. Caption=[no][false][0][Your Caption Text]
  69. Message=[no][false][0][Your initial message]
  70. SETUP1.EXE=[SETUP1.EXE][Your alternative to SETUP1.EXE]
  71. DateFile=[GBSETUP.DAT][Your alternative to GBSETUP.DAT]
  72. WindowWidth=[300][Width in pixels]
  73. WindowHeight=[200][Height in pixels]
  74.  
  75. ***************** PLEASE NOTE *********************
  76. If SETUP.INI is absent, then the following defaults
  77. are set. No error is triggered. Note that ForceCompatible
  78. will make GB SETUP act like MS SETUP always did..
  79.  
  80. ForceCompatible=yes
  81. AlwaysOverwrite=yes
  82. Quick=yes
  83. Caption=SETUP V1.00
  84. Message=Please wait. Initialising...
  85. SETUP1.EXE=SETUP1.EXE
  86. WindowWidth=300
  87. WindowHeight=200
  88. DateFile=GBSETUP.DAT
  89. ***************************************************
  90.  
  91. KEYWORDS
  92. ========
  93. ForceCompatible=
  94. If yes then all additional features of GBSETUP are turned off,
  95. and GB SETUP mimics MS SETUP.
  96. The default of =no is optimum for normal use.
  97.  
  98. AlwaysOverwrite=
  99. If no, then if the target file is present on the users machine,
  100. then it is not recopied. This includes VBRUN300.DLL
  101. N.B. DDEML.DLL and VER.DLL are never overwritten if they are in use.
  102. The SETUP1.EXE file is always copied over.
  103. The default of =no is the optimum for normal use.
  104.  
  105. Quick=
  106. If no, then messages are displayed for a minimum of one second.
  107. For developer testing, =yes is best.
  108.  
  109. Caption=
  110. This is displayed on the title bar of SETUP.
  111. If =n0 then the caption is 'SETUP V1.00'
  112.  
  113. Message=
  114. This is displayed in the window when SETUP starts.
  115. If =no then the default is 'Please wait. Initialising...'
  116.  
  117. SETUP1.EXE=
  118. This is the program that SETUP chains to, passing the driveletter
  119. as a parameter. You may want to change the name of yout VB program.
  120. If you rename it using DOS, then it is expanded to \SYSTEM\SETUP1.EXE.
  121. The default is =SETUP.EXE
  122.  
  123. WindowWidth=
  124. WindowHeight=
  125. This is expressed in pixels.
  126. The default is Width=300, Height=200
  127.  
  128. Datefile=
  129. SETUP creates a small ASCII file on the users \SYSTEM directory.
  130. It is 8 characters long.
  131. Characters 1 and 2 (range 01-99) is an installcounter. Each time
  132. the user runs SETUP, it is incremented by 1.
  133. Characters 3,4,5,6,7 and 8 are the users system date in the
  134. format YYMMDD (ie. 950817 = 17th August 1995)
  135. When the installcounter is incremented, this date is untouched.
  136. Your VB Setup program can therefore use this DATEFILE to gain
  137. information about:
  138. 1) When was the original (first) installation?
  139. 2) How many times has it been re-installed?
  140. The default is 'GBSETUP.DAT'
  141.  
  142.  
  143. REVISION HISTORY
  144. ================
  145. 08/08/95 Birth/Creation
  146. 08/08/95 First public release.
  147. 15/08/95 Bugfix. Current Directory problem fixed.
  148. 16/08/95 New keywords added.
  149. 17/08/95 Bugfix. SETUP.LST read problem fixed.
  150.  
  151.  
  152. ================
  153. Gordon Bamber
  154. 16th August 1995